Miles Sound System SDK 7.2a

WAVELIB - Wave Synthesizer Librarian

Discussion

This utility should now be considered obsolete - all future digital synthesis should be performed with the new DLS functions! WAVELIB only exists for backwards compatibility now.

The WAVELIB program extracts raw PCM sample data from standard Creative Labs Sound Blaster Voice Editor-compatible .VOC files, as well as Microsoft Windows-compatible .WAV files, and stores it in a wave library file for use with XMIDI-sequenced digital sound effects.

WAVELIB has the following command-line syntax:


WAVELIB list_file.TXT

The list file is an unformatted ASCII text file which contains a list of .VOC, .WAV, and/or raw audio data files which are assigned to MIDI Program Change numbers and XMIDI Patch Bank Select values. Upon installing a wave library file with the AIL_create_wave_synthesizer function, the instruments stored in the wave library will replace or add to the default set of MIDI instruments associated with the XMIDI driver in use. MIDI Program Change (and optionally XMIDI Patch Bank Select) messages in a sequence may be used to select a digital sound effect for triggering with subsequent MIDI Note On/Note Off messages. Pitch Bend, Panpot, and Part Volume messages are also emulated by the digital sound-effects system. Rhythm instruments assigned to XMIDI Patch Bank 127 may be mapped to various MIDI note numbers in channel 10, while melodic instruments assigned to other XMIDI Patch Banks (or none at all) are played normally in the other channels.

.VOC and .WAV files specified in the list file must fit into available EMS/XMS memory, and should not contain "silence packing" blocks, infinite repeat loops, or voice blocks with varying sample rates or compression types. IMA ADPCM compression is not supported.

During the conversion process, "repeat blocks" in .VOC files are expanded into multiple instances of the repeated voice data blocks. The "extended block" type introduced with the Sound Blaster Pro developer kit is also supported by WAVELIB, as is the new 16-bit voice block type introduced with the Sound Blaster 16.

The following is a copy of the WAVEDEMO.TXT example list file which is provided with the MSS. Options supported by WAVELIB in this release include the features mentioned above. Later releases of WAVELIB may support additional options; check the WAVEDEMO.TXT file provided with subsequent releases for information on any new features or options.


;*****************************************************************************
;**                                                                         **
;** Example file list for software wave triggers                            **
;**                                                                         **
;** This file describes a set of digital audio samples to be played by the  **
;** digital audio system in response to MIDI Note On/Off events.            **
;**                                                                         **
;**                                                                         **
;**                                                                         **
;** At the beginning of the list file, use:                                 **
;**                                                                         **
;**    F=??? to declare the name of the wave library file to create         **
;**                                                                         **
;**          ??? represents a DOS filename in quotes; e.g. "demo.wvl"       **
;**                                                                         **
;**                                                                         **
;**                                                                         **
;** For each digital audio sample to be played as a MIDI instrument, use:   **
;**                                                                         **
;**    B=nnn to set XMIDI Patch Bank Select (controller 114) value          **
;**                                                                         **
;**          Set this value to 0 if your sequences do not contain Patch     **
;**          Bank Select controllers                                        **
;**                                                                         **
;**    P=nnn to set MIDI patch # for sound (B=0-126) or MIDI trigger key #  **
;**          for rhythm sound (B=127 only)                                  **
;**                                                                         **
;**    R=nnn to set root MIDI note # for sound (B=0-126)                    **
;**                                                                         **
;**          For example, middle C (C5) is note number 60; if R= parameter  **
;**          is not used, a value of 60 is assumed                          **
;**                                                                         **
;**          The R= parameter is not needed for bank 127 (rhythm) sounds    **
;**                                                                         **
;**                                                                         **
;**                                                                         **
;** The following parameters are used with raw data files ONLY:             **
;**                                                                         **
;**    S=nnn to set sample playback rate (11025, 22050, etc.)               **
;**                                                                         **
;**    C=nnn to set # of digital channels (1=mono, 2=stereo)                **
;**                                                                         **
;**    W=nnn to set sample word size (8 or 16 bits)                         **
;**                                                                         **
;**                                                                         **
;**                                                                         **
;** All .VOC/.WAV/raw source filenames must be enclosed in quotes ("")      **
;**                                                                         **
;** Up to 512 samples may appear in one list file.  Lines which begin with  **
;** semicolons are treated as comments.  Blank lines are permitted.         **
;**                                                                         **
;*****************************************************************************
F="demo.wvl"
B=127  , P=60  , S=44100 , C=1 , W=8 , "..\media\welcome.raw"
B=127  , P=61  , S=44100 , C=1 , W=8 , "..\media\flyby.raw"
B=127  , P=62  , S=44100 , C=1 , W=8 , "..\media\she_bop.raw"
B=127  , P=63  , S=44100 , C=1 , W=8 , "..\media\charge.raw"
B=127  , P=64  , S=44100 , C=1 , W=8 , "..\media\klaxon.raw"
B=127  , P=65  , S=44100 , C=1 , W=8 , "..\media\guitar.raw"
B=127  , P=66  , S=44100 , C=1 , W=8 , "..\media\thriller.raw"
B=127  , P=67  , S=44100 , C=1 , W=8 , "..\media\nena.raw"
B=127  , P=68  ,                       "..\media\glass.wav"

Previous Topic (MIDIREC- Standard MIDI File Recorder)

Group: Miles Sound System Tools Reference
Related Functions: AIL_create_wave_synthesizer